
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>搭建自己的MCP服务器并连接Cursor - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>搭建自己的MCP服务器并连接Cursor - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">MCP服务器在Cursor和大型语言模型之间扮演什么角色？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">MCP（Model Control Protocol）服务器是连接Cursor与大型语言模型的桥梁。它本质上是一个API代理，负责接收Cursor发送的请求，将其转发给语言模型处理，然后将结果返回给Cursor，同时处理认证、请求转发和响应。</div>
          </div>
          <div class="card-source">来源: 一、MCP服务器基础知识 -> 1. 什么是MCP服务器及其工作原理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">与使用默认服务相比，搭建本地MCP服务器有哪些主要优势？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">搭建本地MCP服务器的主要优势包括：1. 降低延迟，提高响应速度；2. 避免网络波动导致的连接问题；3. 增强数据隐私保护；4. 可以自定义和优化服务配置；5. 无需担心服务限流或中断。</div>
          </div>
          <div class="card-source">来源: 一、MCP服务器基础知识 -> 2. 为什么需要本地MCP服务器</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">根据文档，构建MCP服务器需要安装哪五个核心Python库，它们各自的作用是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">需要的五个核心库及其作用是：1. FastAPI：用于构建高性能API服务器。2. Uvicorn：作为ASGI服务器来运行FastAPI应用。3. Pydantic：用于数据验证和设置管理。4. python-dotenv：用于管理环境变量。5. openai：用于与OpenAI API进行交互。</div>
          </div>
          <div class="card-source">来源: 二、准备工作 -> 2. 必要库与依赖安装</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">在MCP服务器的项目结构中，`.env`文件的主要用途是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">`.env`文件用于存储敏感信息和配置，例如`OPENAI_API_KEY`、服务器端口`MCP_SERVER_PORT`和主机地址`MCP_SERVER_HOST`，从而将这些配置与代码分离开来。</div>
          </div>
          <div class="card-source">来源: 三、Python实现MCP服务器搭建步骤 -> 1. 基础服务器框架搭建</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">为了处理来自Cursor的请求，文档中的`main.py`实现了一个核心API端点，该端点的路径和HTTP方法是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">核心API端点的路径是`/v1/chat/completions`，它使用HTTP POST方法来接收和处理来自Cursor的聊天补全请求。</div>
          </div>
          <div class="card-source">来源: 三、Python实现MCP服务器搭建步骤 -> 2. API接口设计与实现</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">优化</div>
          <div class="card-question">文档中提到如何配置Uvicorn以提高并发请求处理能力？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">优化</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">通过在Uvicorn的启动命令中添加`workers`参数来处理更多并发请求，例如：`uvicorn.run(app, host=MCP_SERVER_HOST, port=MCP_SERVER_PORT, workers=4)`。</div>
          </div>
          <div class="card-source">来源: 四、MCP服务器优化 -> 3. 并发请求处理</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">配置</div>
          <div class="card-question">如何配置Cursor编辑器以连接到本地搭建的MCP服务器？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">配置</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">在Cursor的设置中，找到“AI”选项卡下的“自定义MCP端点”选项，并输入本地服务器的地址，即`http://localhost:8000/v1/chat/completions`，然后保存。</div>
          </div>
          <div class="card-source">来源: 五、Cursor连接配置 -> 1. Cursor本地MCP设置修改</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">特性</div>
          <div class="card-question">除了标准的聊天补全功能，文档还展示了可以为本地MCP服务器添加哪种高级功能来处理特定任务？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">特性</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">文档展示了可以添加“自定义提示词配置”功能，通过创建一个新的API端点（如`/v1/custom_prompt`），根据预设的模板（如代码审查、文档字符串生成）来处理特定的代码相关任务。</div>
          </div>
          <div class="card-source">来源: 六、实用案例展示 -> 1. 自定义提示词配置</div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">调试</div>
          <div class="card-question">如果Cursor无法连接到本地MCP服务器，文档建议检查哪几个方面来排除故障？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">调试</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">如果连接失败，应检查以下四点：1. MCP服务器是否正在运行。2. 端口是否被防火墙阻止。3. 在Cursor中输入的URL是否正确。4. 服务器的日志中是否有错误信息。</div>
          </div>
          <div class="card-source">来源: 五、Cursor连接配置 -> 3. 连接测试与故障排除</div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
